/ BBS in a Box 12 / BBS in a box XII-2.iso / Files II / Prog / N-P / Open Prolog 1.02.sit / Open Prolog 1.02 / Documents / Exception Handling

< prev

next >

MacOS 8.1

Win98

DOS

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 00 12 45 78 63 65 70 74 | 69 6f 6e 20 48 61 6e 64 |..Except|ion Hand|
|00000010| 6c 69 6e 67 00 00 00 00 | 00 00 00 00 00 00 00 00 |ling....|........|
|00000020| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000030| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000040| 00 54 45 58 54 50 52 4c | 47 01 00 00 00 00 00 00 |.TEXTPRL|G.......|
|00000050| 00 00 00 00 00 0d 4c 00 | 00 01 62 a8 c9 7a 20 a8 |......L.|..b..z .|
|00000060| c9 7a 20 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |.z .....|........|
|00000070| 00 00 00 00 00 00 00 00 | 00 00 81 81 fe 61 00 00 |........|.....a..|
|00000080| a5 20 45 78 63 65 70 74 | 69 6f 6e 20 68 61 6e 64 |. Except|ion hand|
|00000090| 6c 69 6e 67 20 75 73 69 | 6e 67 20 63 61 74 63 68 |ling usi|ng catch|
|000000a0| 2d 61 6e 64 2d 74 68 72 | 6f 77 20 28 4f 70 65 6e |-and-thr|ow (Open|
|000000b0| 20 50 72 6f 6c 6f 67 20 | 31 2e 30 64 33 37 20 61 | Prolog |1.0d37 a|
|000000c0| 6e 64 20 6c 61 74 65 72 | 29 2e 0d 0d 3c 49 6e 66 |nd later|)...<Inf|
|000000d0| 6f 72 6d 61 74 69 6f 6e | 20 74 6f 20 62 65 20 61 |ormation| to be a|
|000000e0| 64 64 65 64 2e 20 49 6e | 20 74 68 65 20 6d 65 61 |dded. In| the mea|
|000000f0| 6e 74 69 6d 65 2c 20 63 | 6f 6e 73 75 6c 74 20 74 |ntime, c|onsult t|
|00000100| 68 65 20 49 53 4f 20 50 | 72 6f 6c 6f 67 20 64 72 |he ISO P|rolog dr|
|00000110| 61 66 74 3e 0d 0d a5 20 | 45 78 63 65 70 74 69 6f |aft>... |Exceptio|
|00000120| 6e 20 48 61 6e 64 6c 69 | 6e 67 20 69 6e 20 62 75 |n Handli|ng in bu|
|00000130| 69 6c 74 2d 69 6e 20 70 | 72 65 64 69 63 61 74 65 |ilt-in p|redicate|
|00000140| 73 20 69 6e 20 4f 70 65 | 6e 20 50 72 6f 6c 6f 67 |s in Ope|n Prolog|
|00000150| 0d 0d 57 68 65 6e 65 76 | 65 72 20 61 6e 20 65 72 |..Whenev|er an er|
|00000160| 72 6f 72 20 69 73 20 64 | 69 73 63 6f 76 65 72 65 |ror is d|iscovere|
|00000170| 64 20 69 6e 20 61 20 62 | 75 69 6c 74 2d 69 6e 2c |d in a b|uilt-in,|
|00000180| 20 61 6e 20 65 72 72 6f | 72 20 74 65 72 6d 20 69 | an erro|r term i|
|00000190| 73 20 74 68 72 6f 77 6e | 2e 20 49 66 20 6e 6f 20 |s thrown|. If no |
|000001a0| 63 61 74 63 68 2f 33 20 | 70 72 65 64 69 63 61 74 |catch/3 |predicat|
|000001b0| 65 20 69 6e 74 65 72 76 | 65 6e 65 73 2c 20 74 68 |e interv|enes, th|
|000001c0| 65 20 65 72 72 6f 72 20 | 74 65 72 6d 20 77 69 6c |e error |term wil|
|000001d0| 6c 20 62 65 20 63 61 75 | 67 68 74 20 62 79 20 74 |l be cau|ght by t|
|000001e0| 68 65 20 64 65 66 61 75 | 6c 74 20 63 61 74 63 68 |he defau|lt catch|
|000001f0| 65 72 20 77 68 69 63 68 | 20 77 69 6c 6c 20 6f 75 |er which| will ou|
|00000200| 74 70 75 74 20 61 20 73 | 75 69 74 61 62 6c 65 20 |tput a s|uitable |
|00000210| 65 72 72 6f 72 20 6d 65 | 73 73 61 67 65 20 61 6e |error me|ssage an|
|00000220| 64 20 61 62 6f 72 74 20 | 74 68 65 20 70 72 6f 67 |d abort |the prog|
|00000230| 72 61 6d 2e 0d 0d 54 68 | 65 20 66 6f 72 6d 20 6f |ram...Th|e form o|
|00000240| 66 20 74 68 65 20 74 65 | 72 6d 20 74 68 61 74 27 |f the te|rm that'|
|00000250| 73 20 74 68 72 6f 77 6e | 20 69 73 3a 20 65 72 72 |s thrown| is: err|
|00000260| 6f 72 28 4b 69 6e 64 2c | 4c 69 73 74 4f 66 49 6e |or(Kind,|ListOfIn|
|00000270| 66 6f 72 6d 61 74 69 6f | 6e 29 2e 0d 54 68 65 20 |formatio|n)..The |
|00000280| 4b 69 6e 64 20 69 73 20 | 6f 6e 65 20 6f 66 20 74 |Kind is |one of t|
|00000290| 68 65 20 49 53 4f 20 50 | 72 6f 6c 6f 67 20 44 72 |he ISO P|rolog Dr|
|000002a0| 61 66 74 20 65 72 72 6f | 72 73 2c 20 70 6c 75 73 |aft erro|rs, plus|
|000002b0| 20 74 77 6f 20 6d 6f 72 | 65 2e 20 48 65 72 65 20 | two mor|e. Here |
|000002c0| 69 73 20 74 68 65 20 6c | 69 73 74 20 6f 66 20 61 |is the l|ist of a|
|000002d0| 6c 6c 20 6f 66 20 74 68 | 65 6d 3a 0d 0d 75 6e 63 |ll of th|em:..unc|
|000002e0| 6c 61 73 73 69 66 69 65 | 64 5f 65 72 72 6f 72 09 |lassifie|d_error.|
|000002f0| 25 74 68 69 73 20 69 73 | 20 6e 6f 74 20 70 61 72 |%this is| not par|
|00000300| 74 20 6f 66 20 49 53 4f | 0d 75 73 65 72 5f 69 6e |t of ISO|.user_in|
|00000310| 74 65 72 72 75 70 74 20 | 25 74 68 69 73 20 69 73 |terrupt |%this is|
|00000320| 20 6e 6f 74 20 70 61 72 | 74 20 6f 66 20 49 53 4f | not par|t of ISO|
|00000330| 0d 0d 73 79 73 74 65 6d | 5f 65 72 72 6f 72 20 25 |..system|_error %|
|00000340| 61 20 73 79 73 74 65 6d | 5f 65 72 72 6f 72 20 63 |a system|_error c|
|00000350| 61 6e 27 74 20 62 65 20 | 63 61 75 67 68 74 20 62 |an't be |caught b|
|00000360| 79 20 61 20 63 61 74 63 | 68 2f 33 20 70 72 65 64 |y a catc|h/3 pred|
|00000370| 69 63 61 74 65 2e 0d 63 | 61 6c 63 75 6c 61 74 69 |icate..c|alculati|
|00000380| 6f 6e 5f 65 72 72 6f 72 | 0d 64 61 74 61 62 61 73 |on_error|.databas|
|00000390| 65 5f 65 72 72 6f 72 0d | 65 76 61 6c 75 61 74 69 |e_error.|evaluati|
|000003a0| 6f 6e 5f 65 72 72 6f 72 | 0d 69 6d 70 6c 65 6d 65 |on_error|.impleme|
|000003b0| 6e 74 61 74 69 6f 6e 5f | 65 72 72 6f 72 0d 69 6e |ntation_|error.in|
|000003c0| 73 74 61 6e 74 69 61 74 | 69 6f 6e 5f 65 72 72 6f |stantiat|ion_erro|
|000003d0| 72 0d 69 6f 5f 63 6f 6e | 74 72 6f 6c 5f 65 72 72 |r.io_con|trol_err|
|000003e0| 6f 72 0d 69 6f 5f 65 6e | 64 5f 6f 66 5f 66 69 6c |or.io_en|d_of_fil|
|000003f0| 65 5f 65 72 72 6f 72 0d | 69 6f 5f 66 6f 72 6d 61 |e_error.|io_forma|
|00000400| 74 74 69 6e 67 5f 65 72 | 72 6f 72 0d 6f 70 65 72 |tting_er|ror.oper|
|00000410| 61 74 6f 72 5f 65 72 72 | 6f 72 0d 6f 76 65 72 66 |ator_err|or.overf|
|00000420| 6c 6f 77 5f 65 72 72 6f | 72 0d 64 6f 6d 61 69 6e |low_erro|r.domain|
|00000430| 5f 65 72 72 6f 72 20 25 | 77 61 73 20 72 61 6e 67 |_error %|was rang|
|00000440| 65 5f 65 72 72 6f 72 0d | 73 79 6e 74 61 78 5f 65 |e_error.|syntax_e|
|00000450| 72 72 6f 72 0d 74 79 70 | 65 5f 65 72 72 6f 72 0d |rror.typ|e_error.|
|00000460| 75 6e 64 65 66 69 6e 65 | 64 5f 70 72 65 64 69 63 |undefine|d_predic|
|00000470| 61 74 65 5f 65 72 72 6f | 72 0d 75 6e 64 65 66 69 |ate_erro|r.undefi|
|00000480| 6e 65 64 5f 76 61 6c 75 | 65 5f 65 72 72 6f 72 0d |ned_valu|e_error.|
|00000490| 75 6e 64 65 72 66 6c 6f | 77 5f 65 72 72 6f 72 0d |underflo|w_error.|
|000004a0| 7a 65 72 6f 5f 64 69 76 | 69 64 65 5f 65 72 72 6f |zero_div|ide_erro|
|000004b0| 72 0d 0d 41 74 20 74 68 | 65 20 6d 6f 6d 65 6e 74 |r..At th|e moment|
|000004c0| 2c 20 74 68 65 20 6d 61 | 6a 6f 72 69 74 79 20 6f |, the ma|jority o|
|000004d0| 66 20 62 75 69 6c 74 2d | 69 6e 73 20 72 65 70 6f |f built-|ins repo|
|000004e0| 72 74 20 61 6e 20 75 6e | 63 6c 61 73 73 69 66 69 |rt an un|classifi|
|000004f0| 65 64 5f 65 72 72 6f 72 | 2e 20 41 73 20 74 69 6d |ed_error|. As tim|
|00000500| 65 20 67 6f 65 73 20 62 | 79 2c 20 74 68 65 79 20 |e goes b|y, they |
|00000510| 77 69 6c 6c 20 62 65 20 | 63 6f 72 72 65 63 74 6c |will be |correctl|
|00000520| 79 20 63 6c 61 73 73 69 | 66 69 65 64 2e 0d 0d 54 |y classi|fied...T|
|00000530| 6f 20 73 65 65 20 73 6f | 6d 65 20 65 72 72 6f 72 |o see so|me error|
|00000540| 73 20 62 65 69 6e 67 20 | 74 68 72 6f 77 6e 20 61 |s being |thrown a|
|00000550| 6e 64 20 63 61 75 67 68 | 74 2c 20 74 72 79 20 74 |nd caugh|t, try t|
|00000560| 68 65 20 66 6f 6c 6c 6f | 77 69 6e 67 20 70 72 65 |he follo|wing pre|
|00000570| 64 69 63 61 74 65 73 3a | 0d 0d 74 61 62 28 5f 29 |dicates:|..tab(_)|
|00000580| 2e 0d 74 61 62 28 61 29 | 2e 0d 74 61 62 28 2d 31 |..tab(a)|..tab(-1|
|00000590| 29 2e 0d 6c 69 73 74 69 | 6e 67 28 5f 29 2e 0d 73 |)..listi|ng(_)..s|
|000005a0| 65 65 28 27 6e 6f 6e 20 | 65 78 69 73 74 65 6e 74 |ee('non |existent|
|000005b0| 20 66 69 6c 65 27 29 2e | 0d 74 65 6c 6c 28 27 6e | file').|.tell('n|
|000005c0| 6f 6e 20 65 78 69 73 74 | 65 6e 74 20 76 6f 6c 75 |on exist|ent volu|
|000005d0| 6d 65 3a 66 69 6c 65 27 | 29 2e 0d 58 20 69 73 20 |me:file'|)..X is |
|000005e0| 61 2e 0d 0d 54 68 65 20 | 4c 69 73 74 4f 66 49 6e |a...The |ListOfIn|
|000005f0| 66 6f 72 6d 61 74 69 6f | 6e 20 6d 61 79 20 63 6f |formatio|n may co|
|00000600| 6e 74 61 69 6e 20 61 75 | 78 69 6c 69 61 72 79 20 |ntain au|xiliary |
|00000610| 69 6e 66 6f 72 6d 61 74 | 69 6f 6e 20 74 68 61 74 |informat|ion that|
|00000620| 20 6d 69 67 68 74 20 62 | 65 20 68 65 6c 70 66 75 | might b|e helpfu|
|00000630| 6c 20 74 6f 20 61 6e 20 | 65 72 72 6f 72 20 68 61 |l to an |error ha|
|00000640| 6e 64 6c 65 72 2c 20 6f | 72 20 69 74 20 63 6f 75 |ndler, o|r it cou|
|00000650| 6c 64 20 62 65 20 65 6d | 70 74 79 2e 20 41 75 78 |ld be em|pty. Aux|
|00000660| 69 6c 69 61 72 79 20 69 | 6e 66 6f 72 6d 61 74 69 |iliary i|nformati|
|00000670| 6f 6e 20 77 69 6c 6c 20 | 62 65 20 6f 66 20 74 68 |on will |be of th|
|00000680| 65 20 66 6f 72 6d 20 3c | 63 61 74 65 67 6f 72 79 |e form <|category|
|00000690| 3e 28 49 6e 66 6f 72 6d | 61 74 69 6f 6e 29 2e 20 |>(Inform|ation). |
|000006a0| 54 68 69 73 20 73 63 68 | 65 6d 65 20 69 73 20 66 |This sch|eme is f|
|000006b0| 6c 65 78 69 62 6c 65 2c | 20 69 6e 20 74 68 61 74 |lexible,| in that|
|000006c0| 20 74 68 65 20 6c 69 73 | 74 20 63 61 6e 20 63 6f | the lis|t can co|
|000006d0| 6e 74 61 69 6e 20 61 6e | 79 74 68 69 6e 67 20 72 |ntain an|ything r|
|000006e0| 65 6d 6f 74 65 6c 79 20 | 75 73 65 66 75 6c 2c 20 |emotely |useful, |
|000006f0| 61 6e 64 20 74 68 65 20 | 65 72 72 6f 72 20 68 61 |and the |error ha|
|00000700| 6e 64 6c 65 72 20 63 61 | 6e 20 61 63 63 65 73 73 |ndler ca|n access|
|00000710| 20 61 6e 79 74 68 69 6e | 67 20 69 74 20 75 6e 64 | anythin|g it und|
|00000720| 65 72 73 74 61 6e 64 73 | 20 77 68 69 6c 65 20 69 |erstands| while i|
|00000730| 67 6e 6f 72 69 6e 67 20 | 74 68 65 20 72 65 73 74 |gnoring |the rest|
|00000740| 2e 20 41 73 20 4f 70 65 | 6e 20 50 72 6f 6c 6f 67 |. As Ope|n Prolog|
|00000750| 20 65 76 6f 6c 76 65 73 | 2c 20 74 68 65 20 61 75 | evolves|, the au|
|00000760| 78 69 6c 69 61 72 79 20 | 69 6e 66 6f 72 6d 61 74 |xiliary |informat|
|00000770| 69 6f 6e 20 6d 61 79 20 | 69 6e 63 72 65 61 73 65 |ion may |increase|
|00000780| 2e 20 54 68 65 20 66 6f | 6c 6c 6f 77 69 6e 67 20 |. The fo|llowing |
|00000790| 74 65 72 6d 73 20 61 72 | 65 20 75 73 65 64 20 61 |terms ar|e used a|
|000007a0| 74 20 70 72 65 73 65 6e | 74 3a 0d 0d 61 72 67 75 |t presen|t:..argu|
|000007b0| 6d 65 6e 74 5f 69 6e 64 | 65 78 28 4f 66 66 65 6e |ment_ind|ex(Offen|
|000007c0| 64 69 6e 67 41 72 67 75 | 6d 65 6e 74 4e 75 6d 62 |dingArgu|mentNumb|
|000007d0| 65 72 29 09 25 73 74 61 | 72 74 69 6e 67 20 61 74 |er).%sta|rting at|
|000007e0| 20 31 0d 0d 61 72 67 75 | 6d 65 6e 74 28 4f 66 66 | 1..argu|ment(Off|
|000007f0| 65 6e 64 69 6e 67 41 72 | 67 75 6d 65 6e 74 29 2e |endingAr|gument).|
|00000800| 20 56 61 72 69 61 62 6c | 65 73 20 69 6e 20 61 72 | Variabl|es in ar|
|00000810| 67 75 6d 65 6e 74 73 20 | 6d 61 79 20 62 65 20 69 |guments |may be i|
|00000820| 6e 73 74 61 6e 74 69 61 | 74 65 64 20 61 73 20 61 |nstantia|ted as a|
|00000830| 20 72 65 73 75 6c 74 20 | 6f 66 20 74 68 65 20 70 | result |of the p|
|00000840| 61 72 74 69 61 6c 20 65 | 78 65 63 75 74 69 6f 6e |artial e|xecution|
|00000850| 20 6f 66 20 74 68 65 20 | 62 75 69 6c 74 2d 69 6e | of the |built-in|
|00000860| 2e 0d 0d 0d 67 6f 61 6c | 28 43 61 6c 6c 29 2e 20 |....goal|(Call). |
|00000870| 54 68 69 73 20 69 73 20 | 74 68 65 20 67 6f 61 6c |This is |the goal|
|00000880| 20 69 6e 20 77 68 69 63 | 68 20 74 68 65 20 65 78 | in whic|h the ex|
|00000890| 63 65 70 74 69 6f 6e 20 | 6f 63 63 75 72 65 64 2e |ception |occured.|
|000008a0| 20 54 65 72 6d 73 20 74 | 68 61 74 20 77 65 72 65 | Terms t|hat were|
|000008b0| 20 76 61 72 69 61 62 6c | 65 73 20 61 74 20 74 68 | variabl|es at th|
|000008c0| 65 20 73 74 61 72 74 20 | 6f 66 20 74 68 65 20 63 |e start |of the c|
|000008d0| 61 6c 6c 20 6d 61 79 20 | 62 65 20 69 6e 73 74 61 |all may |be insta|
|000008e0| 6e 74 69 61 74 65 64 20 | 61 73 20 61 20 72 65 73 |ntiated |as a res|
|000008f0| 75 6c 74 20 6f 66 20 74 | 68 65 20 70 61 72 74 69 |ult of t|he parti|
|00000900| 61 6c 20 65 78 65 63 75 | 74 69 6f 6e 20 6f 66 20 |al execu|tion of |
|00000910| 74 68 65 20 62 75 69 6c | 74 2d 69 6e 2e 0d 0d 49 |the buil|t-in...I|
|00000920| 66 20 74 68 65 20 43 61 | 6c 6c 20 68 61 73 20 76 |f the Ca|ll has v|
|00000930| 65 72 79 20 63 6f 6d 70 | 6c 65 78 20 61 72 67 75 |ery comp|lex argu|
|00000940| 6d 65 6e 74 73 20 28 65 | 2e 67 2e 20 61 73 20 61 |ments (e|.g. as a|
|00000950| 20 72 65 73 75 6c 74 20 | 6f 66 20 61 6e 20 6f 63 | result |of an oc|
|00000960| 63 75 72 20 63 68 65 63 | 6b 20 76 69 6f 6c 61 74 |cur chec|k violat|
|00000970| 69 6f 6e 29 2c 20 74 68 | 65 20 65 72 72 6f 72 20 |ion), th|e error |
|00000980| 68 61 6e 64 6c 65 72 20 | 6d 61 79 20 69 74 73 65 |handler |may itse|
|00000990| 6c 66 20 68 61 6e 67 20 | 75 70 2e 20 49 66 20 79 |lf hang |up. If y|
|000009a0| 6f 75 20 61 62 6f 72 74 | 20 75 6e 64 65 72 20 74 |ou abort| under t|
|000009b0| 68 65 73 65 20 63 69 72 | 63 75 6d 73 74 61 6e 63 |hese cir|cumstanc|
|000009c0| 65 73 2c 20 79 6f 75 20 | 6c 6f 73 65 20 74 68 65 |es, you |lose the|
|000009d0| 20 65 72 72 6f 72 20 69 | 6e 66 6f 72 6d 61 74 69 | error i|nformati|
|000009e0| 6f 6e 20 2d 20 73 6f 72 | 72 79 2e 0d 0d 65 72 72 |on - sor|ry...err|
|000009f0| 6f 72 5f 63 6f 64 65 28 | 45 72 72 6f 72 43 6f 64 |or_code(|ErrorCod|
|00000a00| 65 29 2e 20 54 68 69 73 | 20 77 69 6c 6c 20 62 65 |e). This| will be|
|00000a10| 20 61 6e 20 4f 70 65 6e | 20 50 72 6f 6c 6f 67 20 | an Open| Prolog |
|00000a20| 65 72 72 6f 72 20 63 6f | 64 65 2e 20 54 68 65 20 |error co|de. The |
|00000a30| 62 75 69 6c 74 2d 69 6e | 20 27 67 65 74 24 70 72 |built-in| 'get$pr|
|00000a40| 6f 6c 6f 67 24 65 72 72 | 6f 72 24 6d 65 73 73 61 |olog$err|or$messa|
|00000a50| 67 65 27 28 43 6f 64 65 | 2c 4d 65 73 73 61 67 65 |ge'(Code|,Message|
|00000a60| 29 20 63 61 6e 20 62 65 | 20 75 73 65 64 20 74 6f |) can be| used to|
|00000a70| 20 72 65 74 72 69 65 76 | 65 20 74 68 65 20 65 72 | retriev|e the er|
|00000a80| 72 6f 72 20 6d 65 73 73 | 61 67 65 2e 0d 0d 45 78 |ror mess|age...Ex|
|00000a90| 61 6d 70 6c 65 3a 0d 27 | 67 65 74 24 70 72 6f 6c |ample:.'|get$prol|
|00000aa0| 6f 67 24 65 72 72 6f 72 | 24 6d 65 73 73 61 67 65 |og$error|$message|
|00000ab0| 27 28 2d 33 32 37 36 37 | 2c 4d 65 73 73 61 67 65 |'(-32767|,Message|
|00000ac0| 29 2e 0d 0d 65 72 72 6f | 72 5f 6d 65 73 73 61 67 |)...erro|r_messag|
|00000ad0| 65 28 45 72 72 6f 72 4d | 65 73 73 61 67 65 41 74 |e(ErrorM|essageAt|
|00000ae0| 6f 6d 29 2e 0d 0d 68 6f | 73 74 5f 65 72 72 6f 72 |om)...ho|st_error|
|00000af0| 5f 63 6f 64 65 28 4d 61 | 63 45 72 72 6f 72 43 6f |_code(Ma|cErrorCo|
|00000b00| 64 65 4e 75 6d 62 65 72 | 29 2e 20 54 68 69 73 20 |deNumber|). This |
|00000b10| 77 69 6c 6c 20 62 65 20 | 61 20 73 74 61 6e 64 61 |will be |a standa|
|00000b20| 72 64 20 4d 61 63 69 6e | 74 6f 73 68 20 65 72 72 |rd Macin|tosh err|
|00000b30| 6f 72 20 63 6f 64 65 2e | 20 54 68 65 20 62 75 69 |or code.| The bui|
|00000b40| 6c 74 2d 69 6e 20 27 67 | 65 74 24 68 6f 73 74 24 |lt-in 'g|et$host$|
|00000b50| 65 72 72 6f 72 24 6d 65 | 73 73 61 67 65 27 28 43 |error$me|ssage'(C|
|00000b60| 6f 64 65 2c 4d 65 73 73 | 61 67 65 29 20 63 61 6e |ode,Mess|age) can|
|00000b70| 20 62 65 20 75 73 65 64 | 20 74 6f 20 72 65 74 72 | be used| to retr|
|00000b80| 69 65 76 65 20 74 68 65 | 20 65 72 72 6f 72 20 6d |ieve the| error m|
|00000b90| 65 73 73 61 67 65 2e 0d | 0d 45 78 61 6d 70 6c 65 |essage..|.Example|
|00000ba0| 3a 0d 27 67 65 74 24 68 | 6f 73 74 24 65 72 72 6f |:.'get$h|ost$erro|
|00000bb0| 72 24 6d 65 73 73 61 67 | 65 27 28 2d 33 39 2c 4d |r$messag|e'(-39,M|
|00000bc0| 65 73 73 61 67 65 29 2e | 0d 0d 68 6f 73 74 5f 65 |essage).|..host_e|
|00000bd0| 72 72 6f 72 5f 6d 65 73 | 73 61 67 65 28 4d 65 73 |rror_mes|sage(Mes|
|00000be0| 73 61 67 65 41 74 6f 6d | 29 2e 20 54 68 69 73 20 |sageAtom|). This |
|00000bf0| 77 69 6c 6c 20 62 65 20 | 61 20 73 74 72 69 6e 67 |will be |a string|
|00000c00| 20 6f 66 20 74 65 78 74 | 20 66 72 6f 6d 20 74 68 | of text| from th|
|00000c10| 65 20 4d 61 63 69 6e 74 | 6f 73 68 2e 0d 0d 49 66 |e Macint|osh...If|
|00000c20| 20 79 6f 75 20 61 72 65 | 20 62 75 69 6c 64 69 6e | you are| buildin|
|00000c30| 67 20 61 6e 20 65 72 72 | 6f 72 20 65 78 63 65 70 |g an err|or excep|
|00000c40| 74 69 6f 6e 20 63 61 74 | 63 68 65 72 2c 20 70 6c |tion cat|cher, pl|
|00000c50| 65 61 73 65 20 64 6f 20 | 6e 6f 74 20 61 73 73 75 |ease do |not assu|
|00000c60| 6d 65 20 74 68 61 74 20 | 74 68 65 20 6f 72 64 65 |me that |the orde|
|00000c70| 72 20 6f 66 20 61 70 70 | 65 61 72 61 6e 63 65 20 |r of app|earance |
|00000c80| 6f 66 20 61 75 78 69 6c | 69 61 72 79 20 69 6e 66 |of auxil|iary inf|
|00000c90| 6f 72 6d 61 74 69 6f 6e | 20 69 6e 20 74 68 65 20 |ormation| in the |
|00000ca0| 6c 69 73 74 20 77 69 6c | 6c 20 72 65 6d 61 69 6e |list wil|l remain|
|00000cb0| 20 73 74 61 62 6c 65 20 | 64 75 72 69 6e 67 20 70 | stable |during p|
|00000cc0| 72 6f 67 72 61 6d 20 65 | 78 65 63 75 74 69 6f 6e |rogram e|xecution|
|00000cd0| 2c 20 6f 72 20 65 76 65 | 6e 20 74 68 61 74 20 74 |, or eve|n that t|
|00000ce0| 68 65 20 73 61 6d 65 20 | 61 6d 6f 75 6e 74 20 6f |he same |amount o|
|00000cf0| 66 20 69 6e 66 6f 72 6d | 61 74 69 6f 6e 20 77 69 |f inform|ation wi|
|00000d00| 6c 6c 20 72 65 73 75 6c | 74 20 65 61 63 68 20 74 |ll resul|t each t|
|00000d10| 69 6d 65 20 74 68 65 20 | 73 61 6d 65 20 65 72 72 |ime the |same err|
|00000d20| 6f 72 20 6f 63 63 75 72 | 73 2e 20 46 75 72 74 68 |or occur|s. Furth|
|00000d30| 65 72 6d 6f 72 65 2c 20 | 74 68 65 20 61 6d 6f 75 |ermore, |the amou|
|00000d40| 6e 74 20 61 6e 64 20 6f | 72 64 65 72 20 6f 66 20 |nt and o|rder of |
|00000d50| 69 6e 66 6f 72 6d 61 74 | 69 6f 6e 20 77 69 6c 6c |informat|ion will|
|00000d60| 20 63 68 61 6e 67 65 20 | 61 73 20 4f 70 65 6e 20 | change |as Open |
|00000d70| 50 72 6f 6c 6f 67 20 65 | 76 6f 6c 76 65 73 2c 20 |Prolog e|volves, |
|00000d80| 61 6c 74 68 6f 75 67 68 | 20 74 68 65 20 73 74 61 |although| the sta|
|00000d90| 6e 64 61 72 64 20 3c 63 | 61 74 65 67 6f 72 79 3e |ndard <c|ategory>|
|00000da0| 73 20 77 69 6c 6c 20 72 | 65 6d 61 69 6e 20 74 68 |s will r|emain th|
|00000db0| 65 20 73 61 6d 65 2c 20 | 61 73 20 66 61 72 20 61 |e same, |as far a|
|00000dc0| 73 20 70 6f 73 73 69 62 | 6c 65 2e 0d 00 00 00 00 |s possib|le......|
|00000dd0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000de0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000df0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000e00| 00 00 01 00 00 00 01 30 | 00 00 00 30 00 00 00 32 |.......0|...0...2|
|00000e10| 20 20 54 59 50 45 0d 20 | 20 20 20 20 20 20 20 69 |  TYPE. |       i|
|00000e20| 6e 74 65 67 65 72 48 61 | 6e 64 6c 65 20 3d 20 5e |ntegerHa|ndle = ^|
|00000e30| 12 45 78 63 65 70 74 69 | 6f 6e 20 48 61 6e 64 6c |.Excepti|on Handl|
|00000e40| 69 6e 67 6e 02 00 00 00 | 50 61 72 74 53 49 54 21 |ingn....|PartSIT!|
|00000e50| 00 00 50 61 72 74 53 49 | 54 21 00 00 00 00 00 00 |..PartSI|T!......|
|00000e60| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000e70| 00 00 a9 c7 3a 27 00 00 | 00 00 00 00 01 62 3b 0d |....:'..|.....b;.|
|00000e80| 20 20 20 20 20 20 20 20 | 6c 6f 6e 67 69 6e 74 50 |        |longintP|
|00000e90| 74 72 20 3d 20 5e 6c 6f | 6e 67 69 6e 74 3b 0d 0d |tr = ^lo|ngint;..|
|00000ea0| 20 20 20 20 20 20 56 41 | 52 0d 20 20 20 20 20 20 |      VA|R.      |
|00000eb0| 20 20 6e 75 6d 62 65 72 | 4f 66 4d 65 6e 75 73 2c |  number|OfMenus,|
|00000ec0| 20 69 3a 20 69 6e 74 65 | 67 65 72 3b 0d 20 20 20 | i: inte|ger;.   |
|00000ed0| 20 20 20 20 20 74 68 65 | 4d 65 6e 75 48 61 6e 64 |     the|MenuHand|
|00000ee0| 6c 65 3a 20 6d 65 6e 75 | 48 61 6e 64 6c 65 3b 0d |le: menu|Handle;.|
|00000ef0| 20 20 20 20 20 20 20 20 | 74 68 65 4d 65 6e 75 4c |        |theMenuL|
|00000f00| 00 00 00 2c 01 02 80 08 | 00 00 05 31 2e 30 2e 32 |...,....|...1.0.2|
|00000f10| 1f 44 6f 63 75 6d 65 6e | 74 73 20 66 6f 72 20 4f |.Documen|ts for O|
|00000f20| 70 65 6e 20 50 72 6f 6c | 6f 67 20 31 2e 30 2e 32 |pen Prol|og 1.0.2|
|00000f30| 00 00 01 00 00 00 01 30 | 00 00 00 30 00 00 00 32 |.......0|...0...2|
|00000f40| 00 46 73 f8 19 b6 00 00 | 00 1c 00 32 00 00 76 65 |.Fs.....|...2..ve|
|00000f50| 72 73 00 00 00 0a 00 01 | ff ff 00 00 00 00 00 46 |rs......|.......F|
|00000f60| 73 8c 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |s.......|........|
|00000f70| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
+--------+-------------------------+-------------------------+--------+--------+